home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
utility3
/
bc_cdk.zip
/
CDK_BC.TXT
Wrap
Text File
|
1991-09-01
|
23KB
|
578 lines
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
I wrote this description to help anyone using Borland's C++
compiler and Integrated Development Environment (IDE) to create
custom controls for use with Microsoft's Visual BASIC. The MS
CDK (Control Development Kit) has a series of example programs
that were written to work with Microsoft C version 6 or later.
This document should help you get them to work using Borland's
development products.
This document assumes that you have purchased the MS CDK product.
I make reference to specific line numbers within the files that
were shipped to me with version 1.0 of that product. When
working with Borland's IDE, you can tell what line that you are
currently editing by referencing the numbers in the bottom left-
hand corner of the active edit window. The numbers shown there
appear in the format:
<line number> : <column position>
for example:
25:32
which says that your cursor is on the 32nd character of line 25.
In this document, I also assume that you have installed your
Borland C++ product in the drive\subdirectory C:\BORLANDC. Also
that after installing the CDK, you have copied the file VBAPI.LIB
to C:\BORLANDC\LIB and the file VBAPI.H to C:\BORLANDC\INCLUDE.
While experimenting with this code, I created a subdirectory
called TEMP under the directory for each control, copied all
files for that control there, and edited the copies. It is NEVER
advisable to edit your original copies of anything. Also
remember that whenever you are coding at a systems-level, you
should save your code frequently.
If you have any comments, suggestions, or neat VBX files, please
feel free to drop me a line in my Compuserve mailbox, or at my
humble homestead at 1188 Morgan Ave, Williamsport, PA 17701.
Throughout this document, I mention products and programs that
are protected by some sort of legal nonsense or another, and I
hope I can appease all legal-eagles by saying that any Borland
product mentioned is trademarked and legally protected by Borland
International Inc. of Scotts Valley, CA. Any Microsoft product
is trademarked and legally protected by Microsoft Corporation of
Redmond, WA. Anything done by you using the descriptions here
should make neither them (nor me) liable for any silliness that
might prevail.
Brent K. Langley Compuserve Userid 70312,2142 Page 1
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
GETTING THE CDK TO WORK:
I have found that in getting the CDK code to work with the IDE
there are 8 steps that I had to follow:
1) Change WINDOWS.H
2) Copy and Rename LibInit.Obj to C:\BORLANDC\LIB\C0VBINIT.OBJ
3) Create a Project file (.PRJ) to create the VBX/DLL file
4) Change CCINIT.C to take advantage of changes in WINDOWS.H
5) Handle any syntax errors in demo code
6) Handle any language incompatibilities in code
7) "Make" Project from IDE
8) Rename (or Copy) xxxxxxxx.DLL to xxxxxxxx.VBX
Steps 1 and 2 from above only need to be done once. Steps 3 and
4 need to be done for every project, but follow the same steps.
Steps 5 and 6 will be addressed separatly for each of the three
example programs that need fixing. Steps 7 and 8 let you put all
of the pieces together.
STEP ONE: CHANGE WINDOWS.H
The normal startup code for a DLL does a little processing and
then calls your function called LibMain. In a .VBX file, we have
to replace the normal startup code with a modified routine that
passes some extra information to our control's LibMain. This
means that the format for calling a VBX's LibMain is different
from a normal DLL's LibMain. This causes no real hassle to
MSC/SDK developers because Microsoft doesn't include a function
prototype in their version of WINDOWS.H for LibMain, however,
Borland does. And when Borland's compiler sees the CDK version
of the LibMain function, it stops compiling with an error.
We could just remove the function prototype for LibMain from
Borland's WINDOWS.H, but it will help us with our syntax checking
if we leave it there. My solution is to define a constant called
_CDK before the #include of WINDOWS.H. Then have WINDOWS.H
determine the existance of this defined constant to decide
whether to use the CDK or normal version of LibMain.
To do this, load C:\BORLANDC\INCLUDE\WINDOWS.H and then press
Ctrl-PgDn to go to the bottom of the file. Move your cursor up
to about line 3473, and you should see Borland's function
prototype for LibMain. I changed this part of the code to be:
#ifndef _CDK
int FAR PASCAL LibMain ( HANDLE, WORD, WORD, LPSTR );
#else
BOOL FAR PASCAL LibMain( HANDLE, HANDLE, unsigned short );
#endif
I used "unsigned short" instead of USHORT for the third parameter
of the CDK version of LibMain because USHORT isn't seen in a
typedef statement until the file VBAPI.H is #include'd later.
Brent K. Langley Compuserve Userid 70312,2142 Page 2
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
STEP TWO: RENAME LIBINIT.OBJ TO C0VBINIT.OBJ
Page 20 of the CDK Guide explains that LIBINIT.OBJ contains
initialization code to replace the code from the file
LIBENTRY.OBJ that is normally linked into DLL projects first. So
we must ensure that the code from LIBINIT.OBJ is linked before
any other code in our projects.
On page 141 of Borland's C++ User Guide, we find the section of
the project manager chapter titled "Overriding Libraries" states
that we can have our own startup file linked first, if:
1) its name starts with C0 (the letter C followed by zero)
2) it is placed as the first file in the project.
We'll worry about making a project file in a minute, but for now,
lets give LibInit.OBJ a new name to conform with step one from
above. While we're at it, lets also move it to a standard
location (since the CDK manual says that this code would seldom
need to change.) If LibInit.OBJ is in your current directory,
type:
COPY LIBINIT.OBJ C:\BORLANDC\LIB\C0VBINIT.OBJ
You could call it anything you want (so long as it starts with
"C0") but since it contains the Visual Basic INITialization code,
I thought that this name was appropriate.
STEP THREE: CREATE A PROJECT FILE
For each control, you will make a project file that looks similar
to the following:
C:\BORLANDC\LIB\C0VBINIT.OBJ
C:\BORLANDC\LIB\C0DC.OBJ
C:\BORLANDC\LIB\VBAPI.LIB
CCINIT.C
program.DEF
program.RC
program.C
.
. (any other program files or libraries)
.
For example, the project for the CNTR control would look like:
C:\BORLANDC\LIB\C0VBINIT.OBJ
C:\BORLANDC\LIB\C0DC.OBJ
C:\BORLANDC\LIB\VBAPI.LIB
CCINIT.C
CNTR.DEF
CNTR.RC
CNTR.C
Brent K. Langley Compuserve Userid 70312,2142 Page 3
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
STEP THREE: CREATE A PROJECT FILE (continued)
The file C:\BORLANDC\LIB\C0DC.OBJ listed in the above projects is
the normal startup code file for Borland C (that has been
superseded by C0VBINIT.OBJ) and should appear immediately after
C0VBINIT.OBJ in your project file. This file should actually be
C0Dx.OBJ where "x" indicates your memory model that you are
compiling with. Since I used the "Compact" memory model for
compiling my projects, this is C0Dc.OBJ in my code examples.
Since a VBX file is a type of DLL, you should let the project
manager know that you will be creating a DLL. You can do this by
typing Alt-O to activate the Options menu. Type A to select your
Application type, and then type D to select DLL. Now when you
save your project, this information will be stored with it.
Besides the interactive way of building a project, you could make
a batch file to create your project files, or you could copy this
text to a .PRJ file, but then remember to run PRJCNVT to change
the old-style text project file to Borland's new project file
format.
An example .BAT file called MAKEPRJ.BAT might contain:
@ECHO OFF
IF "%1"=="" GOTO ERROR
ECHO C:\BORLANDC\LIB\C0VBINIT.OBJ > %1.PRJ
ECHO C:\BORLANDC\LIB\C0DC.OBJ >> %1.PRJ
ECHO C:\BORLANDC\LIB\VBAPI.LIB >> %1.PRJ
ECHO CCINIT.C >> %1.PRJ
ECHO %1.DEF >> %1.PRJ
ECHO %1.RC >> %1.PRJ
ECHO %1.C >> %1.PRJ
PRJCNVT %1.PRJ
GOTO END
:ERROR
ECHO You must specify a project name
:END
This uses the program PRJCNVT.EXE in your C:\BORLANDC\BIN
subdirectory (probably in you PATH) to convert from a text .PRJ
file to Borland's new project file format. The first ECHO
statement creates a new .PRJ file, and the rest of the ECHO
statements append their line of text to this file. The file is
named using whatever you specify on the command line after the
word MAKEPRJ. For Example:
MAKEPRJ CNTR
Would make the project example shown on the previous page and
name it CNTR.PRJ. Remember then to set the Alt-O-A-D options
when you load this into the IDE.
Brent K. Langley Compuserve Userid 70312,2142 Page 4
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
STEP FOUR: CHANGE CCINIT.C
In step one, we modified WINDOWS.H to allow correct function
prototyping of the LibMain function. In the file CCINIT.C we
will take advantage of this change. This is the file where our
version of LibMain is declared, so we want WINDOWS.H to use the
CDK version of the prototype.
This is pretty simple, all you need to do is to include the line:
#define _CDK
before the #include <windows.h> statement in the file CCINIT.C.
I suggest that you type over line 6 in this file which is
currently blank. This will preserve the line numbers for the
rest of the code. CCINIT.C is very similar for each of the
example programs in the CDK, but each does vary slightly. Please
make this change for every sample control project in the CDK.
STEP FIVE: HANDLE SYNTAX ERRORS
STEP SIX: HANDLE ANY LANGUAGE INCOMPATIBILITIES
CIRCLE1, CIRCLE2, and PUSH have no further problems so you can
continue with steps seven and eight for them.
However, there is still some work that needs to be done with the
files for CIRCLE3, CNTR, and PIX. I prefer to address the
problems for each of these programs separately, so please see
their individual descriptions on the following pages.
STEP SEVEN: MAKE PROJECT
You're just about done! Press F9 and the IDE will create your
DLL file. If you prefer to use Borland's MAKE utility, you can
convert your .PRJ file from step three (above) to a .MAK file
with the Borland utility PRJ2MAK and then edit this make file to
tailor it to your own specifications.
STEP EIGHT: RENAME .DLL FILE TO .VBX
The IDE's project manager will create a file with the same
filename as that of your .PRJ file. The resulting file's
extension will be .DLL but the Visual BASIC system will be
expecting a Visual Basic eXtension file. To accomodate Visual
BASIC, just RENAME (I prefer to COPY) name.DLL to name.VBX
That's all there is (as if it isn't enough!) Now you can load
Visual BASIC and select Alt F D for File Add-file and specify
your .VBX file.
Brent K. Langley Compuserve Userid 70312,2142 Page 5
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
CIRCLE3
In addition to following the steps described above (such as
putting the #define _CDK in CCINIT.C) CIRCLE3 has some
compatibility problems:
CIRCLE3 PROBLEM 1:
On line 114 of CIRCLE.C there is a call to VBCreateHsz that uses
the new MS C v6 type keyword "_segment". My info on this keyword
comes from an article in the March 1990 issue of Microsoft
Systems Journal by Noel J. Bergman. While describing the new (at
that time) version 6 of MS C, he describes briefly, on page 58,
the concept of "based pointers" and the function of _segement.
He says: "When _segment is used to cast a near address, the
result is the current value in DS" which can be obtained in BC++
by specifying _DS or FP_SEG( (void far *) addr ). He continues:
"If the address is a far address, the result is the segment for
that far address." You can use the FP_SEG( addr ) macro in dos.h
to get this value.
A consistent way to handle both cases would be to use the FP_SEG
macro and cast (void far *) on the pointer. For example:
FP_SEG( (void far *) addr )
Or, since the macro does this casting for you internally, you can
abbreviate this as just:
FP_SEG( addr )
A side note: when looking in the include file dos.h I found that
FP_SEG is using a cast operation with the word _seg !?! What is
that?? Is it the same as _segment ?? It doesn't seem so. Since
I couldn't find it in the documentation, lets play it safe and
stick with FP_SEG. Although, if you are converting a MAJOR
project, you could speed up the conversion by doing a global
search and replace: changing all
(_segment)
to
(void _seg *)(void far *)
Using FP_SEG is easier to read (I think), and a little more
portable. The choice is up to you, but for this example, lets
change line 114 of CIRCLE.C to read:
hsz = VBCreateHsz( FP_SEG(hctl), (LPSTR)lp);
and then put the #include <dos.h> on the blank line between the
includes for <windows.h> and <vbapi.h> (this will preserve line
numbers for the further editing that we have to do...)
Brent K. Langley Compuserve Userid 70312,2142 Page 6
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
CIRCLE3 PROBLEM 2:
In line 406 of CIRCLE.C, the reference to FlashDlgProc is meant
to pass the address of a certain type of function to the function
VBDialogBoxParam. It's function prototype on line 423 is:
BOOL FAR PASCAL _export FlashDlgProc(HWND, USHORT, USHORT, LONG)
but what is required for VBDialogBoxParam (on line 309 of
VBAPI.H) is the type FARPROC that is defined on line 151 of
WINDOWS.H as:
typedef int (FAR PASCAL * FARPROC)();
OK, so all we need to do is cast this FARPROC type on the
function FlashDlgProc. Change line 406 of CIRCLE.C to read:
VBDialogBoxParam(hmodDLL, "FlashDlg", (FARPROC)FlashDlgProc, 0L);
Now your CIRCLE3.PRJ should compile cleanly. Remember to rename
(or copy) CIRCLE3.DLL to CIRCLE3.VBX then fire up Visual BASIC
and try it out!
Brent K. Langley Compuserve Userid 70312,2142 Page 7
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
CNTR
CNTR, the counter control uses "based pointers" in a couple of
its modules so there is some conversion that needs to be done,
but there is an error (BUG??) in CCINIT.C that we must fix first.
In CCINIT.C on line 45, the function modifier "PASCAL" is
missing from the definition of the function LibMain, so change
this line from:
BOOL FAR LibMain
To:
BOOL FAR PASCAL LibMain
Also, at the top of CCINIT.C (line 6, for example) remember to
place the statement:
#define _CDK
In CNTR.H and CNTR.C we need to remove the based pointer
references and replace them with their equivalents in terms of
far pointers. I'm not sure why Microsoft added this based
pointer complexity to this program, unless its that they felt
that it would make the code run faster (using 16 bit pointers
rather than 32 bit.) But I don't think that this is the type of
application that would benefit from the added complication.
In CNTR.H we have some stuff to clean up. Lines 26 through 34
and also line 54 should be commented out as shown below:
// _segment segCntr;
// #define BP _based(segCntr) * // based pointer
// #define BH BP BP // based handle
// typedef VOID BH BHVOID; // void handle
// typedef CHAR BH BHSTR; // handle to a string
// #define CNTRDEREF(hctl) ((PCNTR)(VOID *) ...
and then change line 52 from:
typedef CNTR BP PCNTR;
to:
typedef CNTR far * PCNTR;
In CNTR.C comment-out line 53 as shown below:
// segCntr = (_segment) hctl;
and change line 54 from:
pcntr = CNTRDEREF(hctl);
to:
pcntr = VBDerefControl(hctl);
Now CNTR should compile ok. Rename CNTR.DLL to CNTR.VBX an go!
Brent K. Langley Compuserve Userid 70312,2142 Page 8
Using Borland C++ IDE with
the Microsoft Visual BASIC Control Development Kit (CDK)
PIX
Remember to put the line:
#define _CDK
on line 6 (the blank line above #include <windows.h>) in the file
CCINIT.C as described in step 4 (above).
Lines 81, 85, and 109 of PIX.C use the non-Borland _segment type
for casting as described for CIRCLE3 (above). On each of these
lines modify reference in the code for
(_segment) hctl
to appear like:
FP_SEG( hctl )
and place the line
#include <dos.h>
at the top of the file PIX.C.
Now this control should compile and link cleanly. Remember to
rename the resultant .DLL file to a .VBX file before you load
Visual BASIC and try it out.
--------------------------------------------------------------
Well, I hope this made enough sense to get you going. I tried to
not only tell you what to do, but to also tell you where in the
various references that I found my information. I hope it helps.
Also, I can't emphasize enough, for you to save your programs
often. A small mistake in your code can cause a Windows
Unexpected Application Error (UAE) and either kick you completely
out of Visual BASIC, kick you out of Windows, reboot your
machine, or freeze your machine. I have encountered all of these
battle scars, but I survived and you will too! Have fun....Brent
Brent K. Langley Compuserve Userid 70312,2142 Page 9